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This document describes a set of routins e which Have been provided at bath 
the monitor end user level to facilitate the following Operations,; 

1) Vidiseector inputE 2) Pot box input; 3) Arm motion; 4} Display list 
generation< 


This program was developed under contract with 
Systems Concepts,Incorporated 
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1. MONITOR ROUTINES 

vidis*ssxs s. c ™ual Bcati L -vscak) 

The ITS routine which is used to do the actual, box scan is able to Jo 
pc ripe cfcive as well as rtonpetSpecEive inputs The ^system, call to initiate 
a scan Is as follows; 

\ , i 

*V$CAN PTAELE 

FTABLE ia an 11 word array which contains the information required for 
performing the acan. The format of each word of the table ia deacrihed 
b elow 3 

0. CONTROL K ITS , „ VTDISE ECTOR CONO 

At present only one control bit ia used. This bit (4.9) determines 
whether or not the job should wait for the scan to completer If the 
bit ia <b, no wait occurs and job is allowed to proceed and the 
interrupt routine handles the actual scan, 

1* -COUNT, ,ARRAY 

This is an AO&JN pointer as CKpiained in the description of +VSCAN. 

2* X RESOLUTION,,Y RESOLUTION 

Each l&-bit integer ■quantity gives the number of pcfnta to be scanned 
On the specified axis. 

The format of the following values Is: 

INTEGER PART,,FRACTIONAL PART 

3. R 1 

4. H2 

5. Cl 

6. R3 
1 , R4 
S + C2 
9, PI 

10. P2 




3. 


The abcve parameters axe Chen used to compute the actual (X h Y) 
position Qf a scan point on the vidisseetor. The actual equations and 
method tan teac he -explained by an ALGOL routine. 

K)R Tl«-0 STEP 1 UNTIL YRES-1 DO 
BEGIN 

Y2H2*V1+1)/(2*™S) 

FOE Xl+O STEP 1 UNTIL XRES-1 DO 
BEGIN 

Y 2t-( 2 * XI+U / ( 2 *KRK&) 

T¥MPtfl*X2-FP2 *YZ+1 
3W-( Rl *X2+ft2*Y24Cl > / TEMP 
Y+(K3*3t2+-KA *Y2-KI2 > / TW 
ARRAY (Y1*XRES+-Sl )+$CAN {X p Y ) 

END 

END 

i 

The k ?QT£ET call 

l . . . ' 

This call gives the user a flexible means of controlling, prog mm 
parameters via the input multiplexor, A maximum of 20 simultaneous 
connections between pots and variables is permitted. Each may be variable 
fixed or floating points If fixed point T it may be on arbitrary byre 
within a word- The usee may specify a mapping fro* pot values to variable 
value# by giving an upper and lower limit. 111060 may be inverted to give 
a backward mapping. Two types of control are provided* absolute and 
incremental. In absolute mode* the true pot position sets the value. This 
may be uaeful for positioning displayed objects with a joystick* The 
Incremental mode permits a variable or set of variables to be changed 
aligbtly without causing a discontinuous jump in their values. The value 
is unchanged at connect time, but rotating the pot adds its scaled increment 
to the variable. Turning It down in the hoctom third, or up in the top 
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third of the pots range causes a faster change so os to keep the contra! 
near cfcntcr. The increase in gain is Inhibited at Low speed* to prevent 
drift due to noise. 

The address of the call points to a table of pot connection specif¬ 
ications . This table consists of up to 20 blocks of 4 words . followed by 
a 3 word. The block format is as follows: 

FQQ/ Multiplexor channel* ^control bits 

F00 + 1/ Byte spec* variable address 
FDD + 2/ Lower limit (Value at pot ■ IS) 

FQQ + 3/ Upper limit (value at pot * iOOOG) 

Control hits: 

Z . ? M delete only (if disconnect previous use of pot, iio new 
attachment) 

1.2 =■ abac 1 Lite if ON, Increnental if OPP 

1.1 - floating, if OH, fixed if CPF. 


Byte Spec: 

0 = full word; standard byte pointer format for partial word 

(no index or indirect allowed). 

The following program will display a 45 degree vector of 177 on the 
scope and permit moving its origin with pots 142 (Y) and 143(X). 


EEC: .PQTSET FTEL 

.DSTABT [-3,QTBL-1] 
,VALUE 
< VALUE 

pmt 142 ,.0 

iiliOD,,DTBL + 1 

200 


; CHAN142*FIKED PT,, INCH. 

; Y FIELD OF PT ]*>DE VOELD 
; VECTOR COES 177 BELOV AND LEFT 
OF ORIGIN 
; TOP OF SCOPE 
; CHAtO.43.FIKT PT-, I NCR. 


177 

143,.0 


i 


5. 



1200 ,.cm -i-1 


X FIELD Of FT MODE WORD 
; LOWER LIMIT X 
; UPPER LIMIT X 
i END , FOT5ET TABLE 
f HO FT. MODE, SCALE 0 INTENEITli 7 
; START AT MIDDLE OF SCOFE, TO 


2QQ 

1777 

0 


DTBL: 


20117 

221000,,101000 


777777,,3000 


VECTOR MORE 

i ESCAPE, INTERS, DX-DY- -177,STOP 


The l ARMQVE call 

SERVO routinss have been incorporated into the ITS Monitor. These 
routines provide -acceleration, and velocity limiting, software position 
limit stops* conversion froo j;oint number to multiplexor channel, and 
some other utility functions. The user communicates with the SERVO 
routines by a series of one word commands. A block of commands is 
transmitted to the system, at one time with a non-interruptitle call as 
follows 3 

MOVE A, [-W* T MMELK.] 

+ARM0VE A, 

This will interpret ARMBLK through ARMBLK+N-1 as SERVO commands with each 
word formatted as follows: 

A.9-4.4 JOINT NUMBER 

4,3^3,7 COMMAND 

3.6 UNUSED 

3.5 INDIRECT 


3*4-3+1 INREX 


2*9-1+1 ADDRESS OR 0FERAKD 


The currently available Joint addresses are: 
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(J - AMF SWING 

1 - AMF VERTICAL 

2 - AHF HORIZONTAL 

3 - AMF YAW {INOPERATIVE) 

k - ALLES HASP TILT 

5 - ALLES HAND GRIP 

6 - ALLES HAND ROTATE 

7 - ALLES HAND EXTEND 

10 - AMF ROLL (INOPERATIVE) 

The currently available commands are: 

0 “ SET DESTINATION 

1 - SET VELOCITY LIMIT 

2 - test magnitude of position error 

a - TEST MAGNITUDE OF VELOCITY 

The operand is computed by adding the contents of the specified INDEX 
register {if JCRfQ) to the right half of the command. The result is masked 
to IE bits. If the Indirect Lit Is ON, the riftht half of the word addressed 
is used as the operand. No further indexing hr indirecting is interpreted. 

The test commands arc "TRUE" if the quantity tested exceeds the operand. 
If any tests arc "TRUE" the ,ARMDVE will ship. The SERVO routines are 
activated by the first .ARMOVE and are turned off by a ,ARMOFT or hilling the 
job. 

A .AKMQVE Is illegal if (1) the arm is In use liy another user, (2) the 
block extends above the uo*t t s memory bound, (1) an indirect reference is 
■out of Loutnls , (.4) an unused command ccd-C or joint number i& specified, or 
(5) the block is over IDQ words long. 


! 
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1 . USER LEVEL ROUT INES 

Vid L&s-cz.i 'Tit.. S.^aiL 

In cu'mec to facilitate the nanparspactlye use of ITS VlDISSECTQR SCAN 
ROUTINE (rVSCAN), a user routine has been provided to set up the input 
paCAmeteCS foe a box JCMw This routine has the following call sequence: 

MOVE1 K.FAKAM 
PUSKJ P,VSCAN 

FARAM is the address of a word table. The famat of this table and 
the meaning of each entry is as follows: 

MOTE; All elements except the first are in floating paint format. 

0. -SIZE* jDATA ARMY 

This is an AOBJM pointer to the array where vidissectar data should 
be stared. If the size specified for the array is taa snail to haId 
the requested data an error will occur and the vidissectar will not 
be started. 

1. X GENTLE 

2. Y CENTER 

Indicates the center position of the scan in vidissector coordinates. 

3. X SIZE 

4. Y SIZE 

Indicates the size of the box to be scanned in vidissector coordinates. 

5. X RESOLUTION 

6 . Y RESOLUTION 

Gives the number Of points to be scanned Oh each axis of the bd*. 

7. ROTATION 

Gives the rotation of the box in radians. 

8. SKEW 

Gives t5«e shew af the box in radians. 




Arm Cant ft? I 


a* 


As a means of simplifying user Control over the arm* an interface 
routine ia provideJ between the user and the system. This routine is 
called in the following, way: 

hJOVEl RATABLE 

FCSHJ P T WAVEft 

ATABLE is an array of new arm/hafld position values. At p re sene 
only 6 motions can be specified* {For purposes of simplicity* the hand 
i£ always kept painting straight down)* 'the y$et> when requesting motion* 
Specifies the location £X,Y*2) of the center of the gripper* as well, as 
the orientation (rotate and tilt) of the hand *nd spread of tha "claw." 

The hose of the X,T # E coordinate system is assumed to be on the flocKr in 
the center of the swing axis* The axis are as shown below; 
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It should be pointed out that because of the geometry of Lite atm,, a 
change in X.Y will cause a change of p since an attempt is made to keep 
the proper orientation of the hand. If a user specifies a position outside 
the limit specified for the axis> the position will peg, at the relevant 
limit, in addition, a null matidn is represented by a word of all ones 
where the new position value is normally found. The Current routine has 
two Additional features; 

1. An attempt Is made to have all requested motinns complete ut the same 
time. 

2. The WAVER subroutine returns to the user as soon as all motion has 
been started. The user can cause his progras to wait for the arm 
motion to complete by doing a FUSHJ to the WWAI'T routine. Correspond-* 

ingly, a change in tilt will cause corrections in the vertical and horiz¬ 
ontal position so that the center of the "claw" will remain at the same 
point, 

Pis olav_ Rout inea 

This package allows a user to build, a display list which may consist of 
any of the following elements; 

1, Control Information j 

a. Intensity sotting 

b. Scale sotting 

2, Point Display 

3, Character Display 

4, Vector Display, 

The code is constructed in such a way that a user can cither call a 
standard set of routines which perform the most commonly requested tasks, 
or else he can build his own special purpose package using the sane basic 
primitives as does the standard package. 
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In should be noted that various routines use some or .all of tht; 
registers W*UWjZZ without restoring their original values. A good 
general tole ts to dot expect any of those regia ters to be preserved fiftsr 
a tall bo the display package. In addition, certain of the functions 
use other registers and this will be pointed out in the individual descrip¬ 
tions . 

Initi a lizing the msplay Package , 

Hie first thing that must be done is to assign a buffer to the display 

package and initialize its state. 

This is accompll-sthed by the following sequence: 

HOVE [BUFFER STAHT 1T BUmii E.N0 ] 

HOVEI W.EPitOREXIT 

Pll$Hj P,DSPRST 

Register W must contain a pointer to the start of the buffer (in the 
left half) and a pointer to the last element of that buffer (In the right 
half). 

Register WW must contain an address to be transferred to if the 
buffer should becoae full while generating the display list. 

Upon returning from DSPRST, the ^DISPLAV' 1 will be In parameter mode, 
the scale will be + and the else will be 7. At this point the user is 
ready to generate displays. 

Eisplay Mod es 

The current package is capable of putting the display in any one of 
four modes* This can be accomplished by a FUSHJ to an appropriate routine. 

The modes and the proper routine used Co place Che display in that 


mode arc as follows: 
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Mode Setting KoutLne 


1 , Pa ra@ie t er- 

2 , Point 

3+ Character 

4. Vee te r ■ 


MOUPKM 

MQDPNT 

HOUChK 

MODVEC 


If the "uISPLAY m was already in the rode requested, nothing happen?■ 
In ell other cases, any necessary clean up is performed before the mode is 
actually changed. 

Parameter Mode Operations MODPE1M 

" ” e ' I ' ' 

Two routines arc provided tar the CKpress purpose: of adjusting these 
quantities. It should also be noted that those routines make sure that the 
"DISPLAY” is in parameter mode. 

Intensity . The calling sequence for an intensity change is; 


MOV El W. SJEW INTENSITY 
FOSLiJ P.DSPBET 


Scale . The calling sequence for a scale change is: 

.KOVEL W. NEWSCALEi-4 
PLTSKJ F.D5PSCL 

Fop EKample: 

if (W> ■= 10 8 

the new scale is 1. 

It Should be pointed out that if the new scale or intensity is the same 
as the current value, the operation is a no-op. in addition, if the Display 11 
is Currently JLn parameter mode, no additional half-words will be added to the 
display list. 

Point Mode 

In order to allow toe same routines to be used for both positioning 
as veil as displaying, the register £ controls itensifications: If (Z) m 0, 
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the display is positioned to the coordinates requested, but no intensification 
occurs* However, when (Z) = 2000, the point is dispiayed. MOTE: Any other 
value in Z will cause randomness. 

The, possible entry points and their meaning arc as follows: 


DSPFLT 

The desired position is found in X and Y as floating 

point values. Registers A, B, 0, »r£ altered and not 

res tored. 

GSPPNT 

IJesired position is found in B and C as fisad point numbers* 

DSFFTtf 

EJiimd as :ibova, except display is assumed to be: in point arnda. 
This entry is useful (aiid also slightly note efficient) when 

displaying a sequence of points, 

KITE: Ail valuer used by the routines mentioned above are 

truncated to 10 bits. 

Character Efode 



Two routines are provided for displaying characters: 


DSPCHR 

Displays a character at the current X*Y position. 

The character to be displayed is found in W, 

DSPTXT 

Displays a text string, produced by the AECIZ 

pseudo-op starting at the most recent coordinates. 

A byte pointer to the string should be in W. 

DSPil&C 

Positions the display to the location Specified in 

r. and C (as fin^d point coordinate values) and then 

displays a Message as described in DSFTXT, 


Both the DSPTXT and US?>!£G routines destroy the current contents of 
register A. 

Vector Display 


The entry 

point for displaying a vector Is DS?V2C* The registers 

E end £ contain 

the values AX and AY, respectively, with the current 

position of the 

display being used os the starting point on the vector. 
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Registers A,9-, and C ate destroyed by this routine. 

Putting Arbitrary Commands. into die display 

Aithough great cate should be exercised in putting cdmmonds directly 
into the buffer, this facility is available through the routine D5PPUT. 

tilts is accomplished by putting 18-bit value to bo placed in tins buffer 
into register W and calling USP^lIT, tiQTK t Since no check j.s made mi the 

input at this point, it is up to the user to make sure the display is in the 
proper unde. 

Terminating the Display List 

When a desired display list has been compLetely generated it must be 
terminated so that it can be displayed on the scope. This is accomplished 
by the routine bSPSTT. Ho arguments arc transmitted, but a ELKO pointer 
to the current display list is returned in register W* This pointer can be 
passed to the system display processor (.DSTAKT) directly or it can he added 
to a list of ELKO pointers and then passed Co the system as a part, of the list 





*PftftECTIOE 10 PAGE 5 

Before The .ARMBTC C4ll , after the program on Page 5 read: 

Note that the program docs not need to he running to move the line on 
the s»eopa. The ,1=0TSET till is illegal if either 1) the user tries to 
connect a pot already in use by another user, 2) the table is mors than 
twenty hie cits long, 3) twenty pets are. already connected. or k) the 
address exceeds the user's memory hound, A pot is disconnected whets 1) 
the uset disconnects it with a >POTSET, 2) the user reduces his memory 
hound below the address the pot controls, or 3) the Job is killed. 





